package cn.iocoder.yudao.module.product.property.service;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.product.property.dal.dataobject.ProductPropertyDO;
import cn.iocoder.yudao.module.product.property.vo.AppProductPropertySaveReqVO;
import cn.iocoder.yudao.module.product.property.vo.ProductPropertyPageReqVO;
import cn.iocoder.yudao.module.product.property.vo.ProductPropertySaveReqVO;
import jakarta.annotation.Nullable;
import jakarta.validation.Valid;

import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Set;

/**
 * 产品 SKU项 Service 实现类
 *
 * @author 芋道源码
 */
public interface ProductPropertyService {

    /**
     * 创建规格项
     * 注意，如果已经存在该规格项，直接返回它的编号即可
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createProperty(@Valid ProductPropertySaveReqVO createReqVO);

    /**
     * 创建规格项
     * 注意，如果已经存在该规格项，直接返回它的编号即可
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createProperty(@Valid AppProductPropertySaveReqVO createReqVO);

    /**
     * 更新规格项
     *
     * @param updateReqVO 更新信息
     */
    void updateProperty(@Valid ProductPropertySaveReqVO updateReqVO);

    /**
     * 更新规格项
     *
     * @param updateReqVO 更新信息
     */
    void updateProperty(@Valid AppProductPropertySaveReqVO updateReqVO);

    /**
     * 删除规格项
     *
     * @param id     编号
     */
    void deletePropertyById(Long id);

    /**
     * 获取属性名称分页
     *
     * @param pageReqVO 分页条件
     * @return 规格项分页
     */
    PageResult<ProductPropertyDO> getPropertyPage(ProductPropertyPageReqVO pageReqVO);

    /**
     * 获得指定编号的规格项
     *
     * @param id 编号
     * @return 规格项
     */
    ProductPropertyDO getProperty(Long id);

    /**
     * 根据规格项的编号的集合，获得对应的规格项数组
     *
     * @param ids 规格项的编号的集合
     * @return 规格项数组
     */
    List<ProductPropertyDO> getPropertyList(Collection<Long> ids);

    /**
     * 根据店铺获得对应的规格项数组
     *
     * @return 规格项数组
     */
    List<ProductPropertyDO> getPropertyList();

    /**
     * 批量保存规格项
     */
    void trySaveProperties(Long shopId, Map<String, Set<String>> data, @Nullable String supplyName);

}
